Skip to content

GH-50808: [Python] Narrow Feather deprecation to V1 format - #50685

Merged
rok merged 4 commits into
apache:mainfrom
tadeja:fup-49590-V1-only
Aug 4, 2026
Merged

GH-50808: [Python] Narrow Feather deprecation to V1 format#50685
rok merged 4 commits into
apache:mainfrom
tadeja:fup-49590-V1-only

Conversation

@tadeja

@tadeja tadeja commented Jul 28, 2026

Copy link
Copy Markdown
Collaborator

Rationale for this change

Follow-up to #49232 (comment) / #49590

What changes are included in this PR?

Remove warnings from write_feather(), read_feather(), read_table(), and FeatherDataset.
Warn only on writing with version=1 / reading Feather V1 file.
Update docs to V1-only and keep IPC migration guide.
Additionally corrected notes like deprecated as of 24.0.0 to 25.0.0 instead.

DeprecationWarning in place of current FutureWarning.

Are these changes tested?

Yes, by CI.

Are there any user-facing changes?

Yes!
Feather V2 APIs no longer emit deprecation warnings.
Reading/writing the legacy Feather V1 format emits DeprecationWarning in place of FutureWarning.

@github-actions github-actions Bot added the awaiting review Awaiting review label Jul 28, 2026
@github-actions

This comment was marked as outdated.

@rok rok left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think this together with change to deprecation warning in #50686 is a good idea to do.

Comment thread python/pyarrow/feather.py
Comment thread python/pyarrow/feather.py
Comment thread docs/source/python/feather.rst
@github-actions github-actions Bot added awaiting changes Awaiting changes awaiting change review Awaiting change review and removed awaiting review Awaiting review awaiting changes Awaiting changes labels Aug 4, 2026
@tadeja
tadeja force-pushed the fup-49590-V1-only branch from d1d5428 to ae7b403 Compare August 4, 2026 11:23
@tadeja tadeja changed the title EXP: [Python] Narrow pyarrow.feather deprecation to Feather V1 format GH-49232: [Python] Narrow Feather deprecation to V1 format Aug 4, 2026
@rok
rok force-pushed the fup-49590-V1-only branch from e13c77d to fcfd9a6 Compare August 4, 2026 11:43
@tadeja
tadeja marked this pull request as ready for review August 4, 2026 12:03
@tadeja
tadeja requested review from AlenkaF and raulcd as code owners August 4, 2026 12:03
@rok

rok commented Aug 4, 2026

Copy link
Copy Markdown
Member

@jorisvandenbossche could you please do a quick check so we perhaps get this into patch release today?

@github-actions github-actions Bot added awaiting merge Awaiting merge and removed awaiting change review Awaiting change review labels Aug 4, 2026
@tadeja

tadeja commented Aug 4, 2026

Copy link
Copy Markdown
Collaborator Author

@github-actions crossbow submit preview-docs

@github-actions

github-actions Bot commented Aug 4, 2026

Copy link
Copy Markdown

Revision: fcfd9a6

Submitted crossbow builds: ursacomputing/crossbow @ actions-a52a1106a3

Task Status
preview-docs GitHub Actions

@jorisvandenbossche jorisvandenbossche left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Based on a very cursory look, this looks good to me!

@rok rok changed the title GH-49232: [Python] Narrow Feather deprecation to V1 format GH-50808: [Python] Narrow Feather deprecation to V1 format Aug 4, 2026
@rok
rok merged commit 7ef5982 into apache:main Aug 4, 2026
47 checks passed
@rok rok removed the awaiting merge Awaiting merge label Aug 4, 2026
raulcd pushed a commit that referenced this pull request Aug 4, 2026
### Rationale for this change
Follow-up to #49232 (comment) / #49590

### What changes are included in this PR?
Remove warnings from `write_feather()`, `read_feather()`, `read_table()`, and `FeatherDataset`.
Warn **only** on writing with `version=1` / reading Feather V1 file.
Update docs to V1-only and keep IPC migration guide.
Additionally corrected notes like `deprecated as of 24.0.0` to `25.0.0` instead.

`DeprecationWarning` in place of current `FutureWarning`.

### Are these changes tested?
Yes, by CI.

### Are there any user-facing changes?
Yes!
Feather V2 APIs no longer emit deprecation warnings.
Reading/writing the legacy Feather V1 format emits `DeprecationWarning` in place of `FutureWarning`.

* GitHub Issue: #50808

Lead-authored-by: Tadeja Kadunc <tadeja.kadunc@gmail.com>
Co-authored-by: tadeja <tadeja@users.noreply.github.com>
Co-authored-by: Rok Mihevc <rok@mihevc.org>
Signed-off-by: Rok Mihevc <rok@mihevc.org>
@rok

rok commented Aug 4, 2026

Copy link
Copy Markdown
Member

@conbench-apache-arrow

Copy link
Copy Markdown

After merging your PR, Conbench analyzed the 4 benchmarking runs that have been run so far on merge-commit 7ef5982.

There were no benchmark performance regressions. 🎉

The full Conbench report has more details. It also includes information about 7 possible false positives for unstable benchmarks that are known to sometimes produce them.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants